gdk_surface_move
gdk_surface_resize
gdk_surface_move_resize
+gdk_surface_move_to_rect
gdk_surface_has_native
gdk_surface_raise
gdk_surface_lower
GDK_TYPE_FILE_LIST
gdk_file_list_get_type
gdk_content_formats_get_type
+gdk_content_formats_builder_get_type
</SECTION>
<SECTION>
gdk_keymap_add_virtual_modifiers
gdk_keymap_map_virtual_modifiers
gdk_keymap_get_modifier_mask
+gdk_keymap_get_display
<SUBSECTION>
gdk_keyval_name
gdk_event_new
gdk_event_copy
gdk_event_get_axes
+gdk_event_get_axis
gdk_event_get_button
gdk_event_get_click_count
gdk_event_get_coords
GDK_TYPE_NOTIFY_TYPE
GDK_IS_EVENT
gdk_event_get_type
+gdk_event_sequence_get_type
</SECTION>
<SECTION>
gdk_drag_get_display
gdk_drag_get_actions
-gdk_drag_get_suggested_action
gdk_drag_get_selected_action
gdk_drag_get_formats
gdk_drag_get_device
'gdkdisplaymanagerprivate.h',
'gdkdisplayprivate.h',
'gdkdndprivate.h',
+ 'gdkdragprivate.h',
'gdkdrawcontextprivate.h',
+ 'gdkdropprivate.h',
'gdkeventsprivate.h',
'gdkframeclockidleprivate.h',
'gdkframeclockprivate.h',
<chapter id="WindowWidgets">
<title>Windows</title>
+ <xi:include href="xml/gtkroot.xml" />
<xi:include href="xml/gtkwindow.xml" />
<xi:include href="xml/gtkdialog.xml" />
<xi:include href="xml/gtkmessagedialog.xml" />
gtk_combo_box_new_with_entry
gtk_combo_box_new_with_model
gtk_combo_box_new_with_model_and_entry
-gtk_combo_box_get_wrap_width
-gtk_combo_box_set_wrap_width
-gtk_combo_box_get_row_span_column
-gtk_combo_box_set_row_span_column
-gtk_combo_box_get_column_span_column
-gtk_combo_box_set_column_span_column
gtk_combo_box_get_active
gtk_combo_box_set_active
gtk_combo_box_get_active_iter
gtk_combo_box_get_popup_accessible
gtk_combo_box_get_row_separator_func
gtk_combo_box_set_row_separator_func
+GtkSensitivityType
gtk_combo_box_set_button_sensitivity
gtk_combo_box_get_button_sensitivity
gtk_combo_box_get_has_entry
gtk_range_set_range
gtk_range_get_round_digits
gtk_range_set_round_digits
-GtkSensitivityType
-gtk_range_set_lower_stepper_sensitivity
-gtk_range_get_lower_stepper_sensitivity
-gtk_range_set_upper_stepper_sensitivity
-gtk_range_get_upper_stepper_sensitivity
gtk_range_get_flippable
gtk_range_set_flippable
gtk_range_get_range_rect
gtk_snapshot_push_rounded_clip
gtk_snapshot_push_cross_fade
gtk_snapshot_push_blend
+gtk_snapshot_push_debug
gtk_snapshot_pop
gtk_snapshot_save
gtk_snapshot_restore
gtk_widget_set_parent_surface
gtk_widget_get_parent_surface
gtk_widget_get_toplevel
+gtk_widget_get_root
gtk_widget_get_ancestor
gtk_widget_is_ancestor
gtk_widget_translate_coordinates
GTK_TYPE_MEDIA_STREAM
gtk_media_stream_get_type
</SECTION>
+
+<SECTION>
+<FILE>gtkroot</FILE>
+<TITLE>GtkRoot</TITLE>
+GtkRoot
+gtk_root_get_for_surface
+<SUBSECTION Private>
+gtk_root_get_type
+</SECTION>
gtk_range_get_type
gtk_recent_manager_get_type
gtk_revealer_get_type
+gtk_root_get_type
gtk_scale_button_get_type
gtk_scale_get_type
gtk_scrollable_get_type
* gtk_accel_label_get_use_underline:
* @accel_label: a #GtkAccelLabel
*
- * Returns: Whether the accel label interprets underscores in it's
- * GtkAccelLabel:label property as mnemonic indicators.
+ * Returns whether the accel label interprets underscores in it's
+ * label property as mnemonic indicators.
* See gtk_accel_label_set_use_underline() and gtk_label_set_use_underline();
+ *
+ * Returns: whether the accel label uses mnemonic underlines
*/
gboolean
gtk_accel_label_get_use_underline (GtkAccelLabel *accel_label)
* gtk_check_button_get_inconsistent:
* @check_button: a #GtkCheckButton
*
- * Returns: %TRUE if @check_button is currently in an 'in between' state,
- * %FALSE otherwise.
+ * Returns whether the check button is in an inconsistent state.
+ *
+ * Returns: %TRUE if @check_button is currently in an 'in between' state, %FALSE otherwise.
*/
gboolean
gtk_check_button_get_inconsistent (GtkCheckButton *check_button)
/**
* gtk_editable_set_text:
* @editable: a #GtkEditable
+ * @text: the text to set
*
* Sets the text in the editable to the given value,
* replacing the current contents.
}
/**
- * gtk_editable_set_property:
+ * gtk_editable_delegate_set_property:
* @object: a #GObject
* @prop_id: a property ID
* @value: value to set
}
/**
- * gtk_editable_get_property:
+ * gtk_editable_delegate_get_property:
* @object: a #GObject
* @prop_id: a property ID
* @value: value to set
* Author(s): Carlos Garnacho <carlosg@gnome.org>
*/
+/**
+ * SECTION:gtkeventcontrollerlegacy
+ * @Short_description: Event controller for miscellaneous events
+ * @Title: GtkEventControllerLegacy
+ * @See_also: #GtkEventController
+ *
+ * #GtkEventControllerLegacy is an event controller that gives you
+ * direct access to the event stream. It should only be used as a
+ * last resort if none of the other event controllers or gestures
+ * do the job.
+ **/
+
#include "config.h"
+
#include "gtkeventcontrollerlegacy.h"
#include "gtkeventcontrollerprivate.h"
#include "gtkmarshalers.h"
* @controller: the object which received the signal.
* @event: the #GdkEvent which triggered this signal
*
- * The GTK+ main loop will emit this signal for each GDK event delivered
- * to @controller.
+ * Emitted for each GDK event delivered to @controller.
*
* Returns: %TRUE to stop other handlers from being invoked for the event
- * and the emission of this signal. %FALSE to propagate the event further.
+ * and the emission of this signal. %FALSE to propagate the event further.
*/
signals[EVENT] =
g_signal_new (I_("event"),
{
}
+/**
+ * gtk_event_controller_legacy_new:
+ *
+ * Creates a new legacy event controller.
+ *
+ * Returns: the newly created event controller.
+ */
GtkEventController *
gtk_event_controller_legacy_new (void)
{
/**
* SECTION:gtkfilterlistmodel
* @title: GtkFilterListModel
- * @short_description: a #GListModel that filters its items
+ * @short_description: A list model that filters its items
* @see_also: #GListModel
*
* #GtkFilterListModel is a list model that filters a given other
/**
* SECTION:gtkflattenlistmodel
* @title: GtkFlattenListModel
- * @short_description: a #GListModel that flattens a given listmodel
+ * @short_description: A list model that flattens a list of lists
* @see_also: #GListModel
*
* #GtkFlattenListModel is a list model that takes a list model containing
G_UNLOCK (global_tables);
}
-/*
+/**
* gtk_im_context_simple_add_compose_file:
* @context_simple: A #GtkIMContextSimple
* @compose_file: The path of compose file
* gtk_info_bar_get_revealed:
* @info_bar: a #GtkInfoBar
*
- * Returns: the current value of the #GtkInfoBar:revealed property.
+ * Returns whether the info bar is currently revealed.
+ *
+ * Returns: the current value of the #GtkInfoBar:revealed property
*/
gboolean
gtk_info_bar_get_revealed (GtkInfoBar *info_bar)
/**
* SECTION:gtkmaplistmodel
* @title: GtkMapListModel
- * @short_description: a #GListModel that maps items from a child list model to
- * a different item
+ * @short_description: A list model that transforms its items
* @see_also: #GListModel
*
* #GtkMapListModel is a list model that takes a list model and maps the items
}
/**
- * gtk_medai_stream_get_ended:
+ * gtk_media_stream_get_ended:
* @self: a #GtkMediaStream
*
* Returns whether the streams playback is finished.
}
/**
- * gtk_overlay_get_overlay_clip_overlay:
+ * gtk_overlay_get_clip_overlay:
* @overlay: a #GtkOverlay
* @widget: an overlay child of #GtkOverlay
*
#include "a11y/gtkentryaccessible.h"
/**
- * SECTION:gtkpasswordhentry
+ * SECTION:gtkpasswordentry
* @Short_description: An entry for secrets
* @Title: GtkPasswordEntry
*
* #GtkPasswordEntry is entry that has been tailored for
- * entering secrets.
+ * entering secrets. It does not show its contents in clear text,
+ * does not allow to copy it to the clipboard, and it shows a
+ * warning when Caps-Lock is engaged.
+ *
+ * GtkPasswordEntry provides no API of its own and should be used
+ * with the #GtkEditable API.
*/
typedef struct {
gint *slider_start,
gint *slider_end);
-GDK_AVAILABLE_IN_ALL
-void gtk_range_set_lower_stepper_sensitivity (GtkRange *range,
- GtkSensitivityType sensitivity);
-GDK_AVAILABLE_IN_ALL
-GtkSensitivityType gtk_range_get_lower_stepper_sensitivity (GtkRange *range);
-GDK_AVAILABLE_IN_ALL
-void gtk_range_set_upper_stepper_sensitivity (GtkRange *range,
- GtkSensitivityType sensitivity);
-GDK_AVAILABLE_IN_ALL
-GtkSensitivityType gtk_range_get_upper_stepper_sensitivity (GtkRange *range);
-
GDK_AVAILABLE_IN_ALL
void gtk_range_set_increments (GtkRange *range,
gdouble step,
#include "gdk/gdk-private.h"
/**
- * SECTION:root
+ * SECTION:gtkroot
* @Title: GtkRoot
- * @Short_description: Root widgets
+ * @Short_description: Interface for root widgets
* @See_also: #GtkWindow
*
* #GtkRoot is the interface implemented by all widgets that can act as a toplevel
* A #GtkSelectionModel supports a single boolean per row indicating if a row is selected
* or not. This can be queried via gtk_selection_model_is_selected(). When the selected
* state of one or more rows changes, the model will emit the
- * GtkSelectionModel::selection-changed signal by calling the
+ * #GtkSelectionModel::selection-changed signal by calling the
* gtk_selection_model_selection_changed() function. The positions given in that signal
* may have their selection state changed, though that is not a requirement.
* If new items added to the model via the #GListModel::items-changed signal are selected
* selection functions do NOT indicate if selection or unselection happened. They are
* only meant to indicate complete failure, like when this mode of selecting is not
* supported by the model.
+ *
* Selections may happen asynchronously, so the only reliable way to find out when an
* item was selected is to listen to the signals that indicate selection.
*/
return iface->is_selected (model, position);
}
+/**
+ * gtk_selection_model_select_item:
+ * @model: a #GtkSelectionModel
+ * @position: the position of the item to select
+ * @exclusive: whether previously selected items should be unselected
+ *
+ * Requests to select an item in the model.
+ */
gboolean
gtk_selection_model_select_item (GtkSelectionModel *model,
guint position,
return iface->select_item (model, position, exclusive);
}
+/**
+ * gtk_selection_model_unselect_item:
+ * @model: a #GtkSelectionModel
+ * @position: the position of the item to unselect
+ *
+ * Requests to unselect an item in the model.
+ */
gboolean
gtk_selection_model_unselect_item (GtkSelectionModel *model,
guint position)
return iface->unselect_item (model, position);
}
+/**
+ * gtk_selection_model_select_range:
+ * @model: a #GtkSelectionModel
+ * @position: the first item to select
+ * @n_items: the number of items to select
+ * @exclusive: whether previously selected items should be unselected
+ *
+ * Requests to select a range of items in the model.
+ */
gboolean
gtk_selection_model_select_range (GtkSelectionModel *model,
guint position,
return iface->select_range (model, position, n_items, exclusive);
}
+/**
+ * gtk_selection_model_unselect_range:
+ * @model: a #GtkSelectionModel
+ * @position: the first item to unselect
+ * @n_items: the number of items to unselect
+ *
+ * Requests to unselect a range of items in the model.
+ */
gboolean
gtk_selection_model_unselect_range (GtkSelectionModel *model,
guint position,
return iface->unselect_range (model, position, n_items);
}
+/**
+ * gtk_selection_model_select_all:
+ * @model: a #GtkSelectionModel
+ *
+ * Requests to select all items in the model.
+ */
gboolean
gtk_selection_model_select_all (GtkSelectionModel *model)
{
return iface->select_all (model);
}
+/**
+ * gtk_selection_model_unselect_all:
+ * @model: a #GtkSelectionModel
+ *
+ * Requests to unselect all items in the model.
+ */
gboolean
gtk_selection_model_unselect_all (GtkSelectionModel *model)
{
return iface->query_range (model, position, start_range, n_items, selected);
}
+/**
+ * gtk_selection_model_selection_changed:
+ * @model: a #GtkSelectionModel
+ * @position: the first changed item
+ * @n_items: the number of changed items
+ *
+ * Helper function for implementations of #GtkSelectionModel.
+ * Call this when a the selection changes to emit the ::selection-changed
+ * signal.
+ */
void
gtk_selection_model_selection_changed (GtkSelectionModel *model,
guint position,
/**
* SECTION:gtkslicelistmodel
* @title: GtkSliceListModel
- * @short_description: a #GListModel that presents a slice out of a larger list
+ * @short_description: A list model that presents a slice out of a larger list
* @see_also: #GListModel
*
* #GtkSliceListModel is a list model that takes a list model and presents a slice of
return debug_node;
}
+/**
+ * gtk_snapshot_push_debug:
+ * @snapshot: a #GtkSnapshot
+ * @message: a printf-style format string
+ * @...: arguments for @message
+ *
+ * Inserts a debug node with a message. Debug nodes don't affect
+ * the rendering at all, but can be helpful in identifying parts
+ * of a render node tree dump, for example in the GTK inspector.
+ */
void
gtk_snapshot_push_debug (GtkSnapshot *snapshot,
const char *message,
return opacity_node;
}
+/**
+ * gtk_snapshot_push_opacity:
+ * @snapshot: a #GtkSnapshot
+ * @opacity: the opacity to use
+ *
+ * Modifies the opacity of an image.
+ *
+ * The image is recorded until the next call to gtk_snapshot_pop().
+ */
void
gtk_snapshot_push_opacity (GtkSnapshot *snapshot,
double opacity)
return blur_node;
}
+/**
+ * gtk_snapshot_push_blur:
+ * @snapshot: a #GtkSnapshot
+ * @radius: the blur radius to use
+ *
+ * Blurs an image.
+ *
+ * The image is recorded until the next call to gtk_snapshot_pop().
+ */
void
gtk_snapshot_push_blur (GtkSnapshot *snapshot,
double radius)
return color_matrix_node;
}
+/**
+ * gtk_snapshot_push_color_matrix:
+ * @snapshot: a #GtkSnapshot
+ * @color_matrix: the color matrix to use
+ * @color_offset: the color offset to use
+ *
+ * Modifies the colors of an image by applying an affine transformation
+ * in RGB space.
+ *
+ * The image is recorded until the next call to gtk_snapshot_pop().
+ */
void
gtk_snapshot_push_color_matrix (GtkSnapshot *snapshot,
const graphene_matrix_t *color_matrix,
return clip_node;
}
+/**
+ * gtk_snapshot_push_clip:
+ * @snapshot: a #GtkSnapshot
+ * @bounds: the rectangle to clip to
+ *
+ * Clips an image to a rectangle.
+ *
+ * The image is recorded until the next call to gtk_snapshot_pop().
+ */
void
gtk_snapshot_push_clip (GtkSnapshot *snapshot,
const graphene_rect_t *bounds)
return clip_node;
}
+/**
+ * gtk_snapshot_push_rounded_clip:
+ * @snapshot: a #GtkSnapshot
+ * @bounds: the rounded rectangle to clip to
+ *
+ * Clips an image to a rounded rectangle.
+ *
+ * The image is recorded until the next call to gtk_snapshot_pop().
+ */
void
gtk_snapshot_push_rounded_clip (GtkSnapshot *snapshot,
const GskRoundedRect *bounds)
return shadow_node;
}
+/**
+ * gtk_snapshot_push_shadow:
+ * @snapshot: a #GtkSnapshot
+ * @shadow: the first shadow specification
+ * @n_shadows: number of shadow specifications
+ *
+ * Applies a shadow to an image.
+ *
+ * The image is recorded until the next call to gtk_snapshot_pop().
+ */
void
gtk_snapshot_push_shadow (GtkSnapshot *snapshot,
const GskShadow *shadow,
/**
* gtk_snapshot_transform:
* @snapshot: a #GtkSnapshot
- * @tranform: (allow-none): the transform to apply
+ * @transform: (allow-none): the transform to apply
*
* Transforms @snapshot's coordinate system with the given @transform.
**/
}
/**
- * gtk_snapshot_transform_translate:
+ * gtk_snapshot_translate:
* @snapshot: a #GtkSnapshot
* @point: the point to translate the snapshot by
*
}
/**
- * gtk_snapshot_transform_translate_3d:
+ * gtk_snapshot_translate_3d:
* @snapshot: a #GtkSnapshot
* @point: the point to translate the snapshot by
*
}
/**
- * gtk_snapshot_transform_rotate:
+ * gtk_snapshot_rotate:
* @snapshot: a #GtkSnapshot
* @angle: the rotation angle, in degrees (clockwise)
*
}
/**
- * gtk_snapshot_transform_rotate_3d:
+ * gtk_snapshot_rotate_3d:
* @snapshot: a #GtkSnapshot
* @angle: the rotation angle, in degrees (clockwise)
* @axis: The rotation axis
/**
* SECTION:gtksortlistmodel
* @title: GtkSortListModel
- * @short_description: a #GListModel that sorts a listmodel
+ * @short_description: A list model that sorts its items
* @see_also: #GListModel
*
* #GtkSortListModel is a list model that takes a list model and
* gtk_spin_button_get_text:
* @spin_button: a #GtkSpinButton
*
+ * Returns the text shown in the entry.
+ *
* Returns: (transfer none): The current text shown in the entry area of @spin_button.
*/
const char *
/**
- * SECTION:GtkTransform
+ * SECTION:gtktransform
* @Title: GtkTransform
* @Short_description: A description for transform operations
*
/**
* SECTION:gtktreelistmodel
- * @Short_description: a List model that can create child models on demand
+ * @Short_description: A list model that can create child models on demand
* @Title: GtkTreeListModel
* @See_also: #GListModel
*
return priv->cursor;
}
+/**
+ * gtk_widget_set_can_pick:
+ * @widget: a #GtkWidget
+ * @can_pick: whether this widget should be able to receive pointer events
+ *
+ * Sets whether @widget can be the target of pointer events and
+ * can be returned by gtk_widget_pick().
+ */
void
gtk_widget_set_can_pick (GtkWidget *widget,
gboolean can_pick)
g_object_notify_by_pspec (G_OBJECT (widget), widget_props[PROP_CAN_PICK]);
}
+/**
+ * gtk_widget_get_can_pick:
+ * @widget: a #GtkWidget
+ *
+ * Queries whether @widget can be the target of pointer events.
+ *
+ * Returns: %TRUE if @widget can receive pointer events
+ */
gboolean
gtk_widget_get_can_pick (GtkWidget *widget)
{
projects / gtk4.git / commitdiff